home *** CD-ROM | disk | FTP | other *** search
/ Network CD 2 / Network CD - Volume 2.iso / programs / internet / tcp / mail / iu-14-as225.lha / INetUtils-1.4 / docs / NNTPxfer.man < prev    next >
Encoding:
Text File  |  1994-10-18  |  4.4 KB  |  120 lines
  1. NNTPXfer                                   NNTPXfer
  2.  
  3. NAME
  4.  
  5.     NNTPXfer - transfer articles from NNTP server host to local storage
  6.  
  7.     newgroup - define newsgroups to be transferred from NNTP server
  8.  
  9.  
  10. SYNOPSIS
  11.  
  12.     NNTPXfer nntpserver activefile [paranoid] [verbose] [sb=smallbuffer]
  13.         [ll=locallow]
  14.  
  15.     newgroup activefile newsgroup
  16.  
  17.  
  18. DESCRIPTION
  19.  
  20.     NNTPxfer transfers articles from the NNTP server host to local
  21.     storage (the UUNews: directory). This may be done for a variety
  22.     of reasons, first and foremost that local access to articles is
  23.     significantly faster than remote, regardless of how high-speed
  24.     the communications link is.
  25.  
  26.     NNTPxfer comes with a small utility program named "newgroup"
  27.     which creates and maintains an active file listing the desired
  28.     newsgroups to be transferred.
  29.  
  30.     NNTPxfer is driven by an ACTIVE file, which lists all the newsgroups
  31.     which are to be transferred from the server and stored locally. The
  32.     ACTIVE file contains one line per newsgroup in the following format:
  33.  
  34.         newsgroup hi lo y/n/m
  35.  
  36.     this will look very familiar to some of you.  :)
  37.  
  38.     The 'hi' and 'lo' are the highest and lowest articles present in the
  39.     newsgroup. You can only trust the 'hi' figure. This file is rewritten
  40.     by NNTPxfer, so you should not put ANYTHING else in the file. 'lo' is
  41.     typically the lowest article available at your NNTPserver. If the
  42.     option LOCALLOW is set, then the value is completely maintained by
  43.     local programs, and NNTPxfer will not modify it.
  44.  
  45.     You choose whatever you want the ACTIVE file name to be. Recommended:
  46.  
  47.         UULib:News/Active
  48.  
  49.     to be consistent with the naming of other network tools on the Amiga.
  50.  
  51.     If PARANOID is set when you start NNTPxfer, the active file will be
  52.     updated after every newsgroup is complete.
  53.  
  54.     If VERBOSE is set when you start NNTPxfer, then NNTPxfer will output
  55.     a line immediately before starting to process a newsgroup, and a
  56.     line immediately after processing that newsgroup, so that you may
  57.     track its progress.
  58.  
  59.     Also, NNTPxfer outputs a line to the logfile for each newsgroup
  60.     which has articles that were transferred. If VERBOSE is set, a
  61.     log entry is also made for newsgroups that did not have new articles
  62.     to be transferred.
  63.  
  64.     If SB or SMALLBUFFER is set when you start NNTPxfer, then the TCP/IP
  65.     socket opened to the NNTP server has its buffer set to a small size
  66.     (200 bytes). This will improve any interactive reponses (such as for
  67.     FTP, IRC, telnet, etc.) but will cause article transfer to take
  68.     longer.
  69.  
  70.     You *must* do a newgroup on every newsgroup you wish to be
  71.     transferred, prior to running NNTPXfer. Otherwise, NNTPXfer will
  72.     not know to transfer the articles.
  73.  
  74.     You *must* have UUNews: assigned to a partition prior to running
  75.     "newgroup". It is *highly recommended* that if you have been using
  76.     AmigaUUCP, that you place you place UUNews in a DIFFERENT directory
  77.     than the one which AmigaUUCP was using. NNTPxfer will transfer
  78.     articles using the same article numbers as your NNTP server has,
  79.     which would confuse AmigaUUCP and most newsreaders to no end.
  80.  
  81.     If you are running GRn, you need to delete (rename) your existing
  82.     GRnrc file, and create a new one, as the article numbers will not
  83.     match. DNews (or any other newsreader/utility that requires .next
  84.     files) will not work when you use NNTPxfer. Others, such as Tin
  85.     and Arn, which maintain their own active file, will need to be set
  86.     up to use the new directory, and rebuild their index files.
  87.  
  88.     NNTPxfer supports an environment variable named NNTPRNEWS. When
  89.     defined, NNTPxfer will call that program, with each incoming news
  90.     article on standard input, and allow it to file that article. This
  91.     allows the input to be filed along with UUCP news, and vice versus.
  92.  
  93.     For example, to be used with the AmigaUUCP RNEWS, the definition
  94.     would be:
  95.  
  96.         SetEnv NNTPRNews uucp:c/rnews -p
  97.  
  98.     with the -p indicating that this is a "postnews" call. Note that for
  99.     maximum speed and efficiency, RNEWS should be a resident program.
  100.  
  101.     When used with UUCP, the article numbers in the ACTIVE file will
  102.     continue to map to those of the NNTP server, *not* the local article
  103.     numbers. This is the way it is supposed to work.
  104.  
  105.  
  106. NOTES
  107.  
  108.     To share a newspool with AmigaUUCP (or C News for that matter),
  109.     you will need to use the NNTPRNews option, otherwise, article
  110.     numbers will not match.
  111.  
  112.  
  113. BUGS/TODO
  114.  
  115.     No bugs known.
  116.  
  117.     It was unfortunate that UULib: and UUNews: were chosen at the
  118.     outset. It implies that these programs are part of AmigaUUCP,
  119.     which is not true. Therefore, these may change in the future.
  120.